home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / supk412.zip / SUPERK.DOC < prev   
Text File  |  1989-05-04  |  42KB  |  881 lines
  1. SuperK v4.12  MiniNet's External Protocol Driver including
  2. JBatch        MiniNet's Driver for Richard B. Johnson's Jmodem Protocol
  3.  
  4. Protocols Supported: Xmodem Checksum, Xmodem CRC, Ymodem (1k Xmodem)
  5.                      Jmodem, WXmodem, K9Xmodem and Super8K  in  full
  6.                      Batch  or  Single File Mode.
  7.  
  8. SuperK is Copyright 12/4/1986, 1989 and JBatch is Copyright 11/01/1988, 1989
  9. by Crater Rim Software. All Rights Reserved.
  10.  
  11. = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  12.  
  13. SuperK Licensing Agreement
  14. --------------------------
  15.    For the sake of clarity,  all references and restrictions to the use  of 
  16.    the  SuperK  also apply to all of the associated support files INCLUDING 
  17.    the K9Xmodem, Super8K and Jbatch protocols. 
  18.  
  19.    SuperK,  its overlays and all of its associated support  files  are  not 
  20.    public domain software, nor are they free software.  SuperK is copyright 
  21.    (C) 1985,  1989 - the K9Xmodem, Super8K, SuperK and JBatch protocols are 
  22.    copyright 1987, 1989 by Crater Rim. 
  23.  
  24.    Non-registered users are granted a limited license to use SuperK version 
  25.    4.xx on a trial basis for  the  purpose  of  determining  whether  these 
  26.    programs are suitable for their needs.  The term of this limited license 
  27.    is  30 days.  Use of SuperK,  except for this limited purpose,  requires 
  28.    registration.  Use of non-registered copies of  SuperK  by  any  person, 
  29.    business,  corporation,  governmental agency or other entity institution 
  30.    is strictly forbidden.  
  31.  
  32.    Registration permits you to use SuperK on a regular basis  on  a  single 
  33.    computer.  A  registered  user  may  use  the  program  on  a  different 
  34.    computer,  but may not use the program on more than one computer at  the 
  35.    same  time.  Registration  also  includes priority support on Underdog's 
  36.    MiniNet  BBS.   Users  need  register  only  one  version   of   SuperK.  
  37.    Registration includes licensed use of all upgrades.  
  38.  
  39.    All corporate,  business,  government or other commercial uses of SuperK 
  40.    must be registered.  We offer quantity discounts and Corporate  or  site 
  41.    licensing is also available.  
  42.  
  43.    No  user  may  modify  SuperK  in any way,  including but not limited to 
  44.    decompiling, disassembling or otherwise reverse engineering the program.  
  45.  
  46.    All users are granted a limited license to copy SuperK version 4.xx only 
  47.    for  the trial use of others subject to the above limitations,  and also 
  48.    the following: 
  49.  
  50.          SuperK  version  4.xx  must  be  copied  in unmodified form, 
  51.          complete with the file containing this license information.  
  52.  
  53.          Any and all SuperK documentation must be included  with  the 
  54.          copy.  No fee,  charge or other compensation may be accepted 
  55.          or requested by any licensee.  
  56.  
  57.          SuperK may not be distributed in conjunction with any  other 
  58.          product without prior arrangements with Crater Rim Software. 
  59.  
  60.    Operators  of electronic bulletin board systems (Sysops) may post SuperK 
  61.    version 4.xx for downloading by their users only as long  as  the  above 
  62.    conditions are met.  
  63.  
  64.    Distributors  of public domain or user supported software may distribute 
  65.    copies of SuperK version 4.xx subject to the above conditions only after 
  66.    obtaining written permission from Crater Rim Software.  Such  permission 
  67.    usually is granted.  Please write or call for details.  
  68.  
  69.  
  70.                   ShareWare Software Discalaimer and Warranty
  71.  
  72.    Crater  Rim Software makes no warranty of any kind,  express or implied, 
  73.    including without limitation,  any warranties of merchantability  and/or 
  74.    fitness  for  a  particular  purpose.  Crater  Rim Software shall not be 
  75.    liable  for  any  damages,   whether  direct,   indirect,   special   or 
  76.    consequential  arising  from a failure of this program to operate in the 
  77.    manner desired by the user.  Crater Rim Software shall not be liable for 
  78.    any damage  to  data  or  property  which  may  be  caused  directly  or 
  79.    indirectly by use of the program.  
  80.  
  81.    IN  NO  EVENT WILL Crater Rim Software BE LIABLE TO YOU FOR ANY DAMAGES, 
  82.    INCLUDING  ANY  LOST  PROFITS,  LOST  SAVINGS  OR  OTHER  INCIDENTAL  OR 
  83.    CONSEQUENTIAL  DAMAGES  ARISING  OUT OF YOUR USE OR INABILITY TO USE THE 
  84.    PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.  
  85.  
  86.    See the Ordering section for more information on registration, corporate 
  87.    licensing and similar topics.  
  88.  
  89.    WARNING:  YOU MAY NOT USE EITHER VERSION OF SuperK ON A REGULAR BASIS 
  90.              WITHOUT REGISTERING THE PACKAGE. 
  91.  
  92. = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  93. SuperK External Protocol Driver - Revision Log
  94.  
  95. V2.50  - Dated 08/22/88  Initial Release
  96. V2.52  - Dated 09/01/88
  97. V3.10  - Dated 11/05/88
  98. V3.12  - Dated 12/04/88
  99. V3.13  - Dated 12/06/88
  100. V3.14  - Dated 12/27/88
  101. V3.15  - Dated 01/07/89
  102. V3.16  - Dated 01/26/89
  103. V4.00  - Dated 02/20/89
  104. V4.10  - Dated 03/29/89  Changes
  105.  
  106.    Modem Buffer size has been increased from 4K to 8K
  107.  
  108.    Sending  files  using  Super8K will now recognize the receipt of an XOFF 
  109.    from the modem.  Upon receipt,  SuperK will cycle for  about  5  seconds 
  110.    waiting for an XON from the modem or a user abort via the Esc or ^X key. 
  111.    Please  Note  that the XOFF/XON support is ONLY for use with MNP modems.  
  112.    The Super8K receiver software does not send the XOFF/XON. 
  113.  
  114.    It has been brought to my attention that the latest MS  Basic  compilers 
  115.    drop the RTS line when performing a DOS shell. SuperK now checks the RTS 
  116.    line upon startup and will raise it if it has been dropped. 
  117.  
  118.    There have also been some reports of memory errors when using SuperK  in 
  119.    EEMS memory...  I suspect that this may have been caused by a Stack/Heap 
  120.    collision  within SuperK.  To this end,  I have increased both the Stack 
  121.    and Heap.  Please check the new memory requirements to be sure that  you 
  122.    have  ample  memory available for SuperK to do its thing!  Please let me 
  123.    know if this problem still exists. 
  124.  
  125.    The  addition  of a Work Path so that SuperK can easily access Read Only 
  126.    files in a networking envirnment (see W - Work Path below). 
  127.  
  128.    Corrected a bug in the Overwrite check.  Under certain circumstances, an 
  129.    I/O error would occur if too many files were rejected by the receiver.
  130.  
  131. V4.11  - Dated 04/05/89  Corrected a minor bug in the ReadOnly copy routine
  132.  
  133. V4.12  - Dated 05/04/89  Changes
  134.  
  135.    In an effort to make Super8K a little more "bullet  proof",  I  reworked
  136.    then Super8K Error Recovery routines.
  137.  
  138.    There have been a number of users having problems with SuperK  reporting
  139.    a run time error of F0=xxxx.  This is due to the fact that SuperK cannot
  140.    find its overlay file, SUPERK.000. Seems there are some (antiquated) BBS
  141.    packages  that change directories before transferring a file!  When this
  142.    happens,  SuperK is unable to find its overalay (or the  SKA.COM  jmodem
  143.    module for that matter).  If this is happening to you,  be sure to start
  144.    up SuperK as   SUPERK @   and define  OVL Path  parameter  to  the  FULL
  145.    drive:\path\  where SUPERK resides.
  146.  
  147.    There are also reports that some BBS software is unable  to  "read"  the 
  148.    SuperK errorlevel returned upon exit. This is a problem with the calling 
  149.    program  NOT  with SuperK as the errorlevel returned is fully recognized 
  150.    by DOS via a batch file. 
  151.  
  152.  
  153. Memory requirements:
  154. ~~~~~~~~~~~~~~~~~~~   
  155.    Jmodem  transfers require a minimum of 125K (128,000 bytes).  All of the 
  156.    other protocols only require about 70K (71,680 bytes). If you don't know 
  157.    how much memory you have available, it can be checked easily as follows: 
  158.  
  159.    1)  Copy  DOS' CHKDSK.COM  to your comm directory.
  160.  
  161.    2)  Start up your comm program and execute the comm program's DOS  shell 
  162.        option. 
  163.  
  164.    3)  Type  CHKDSK  at the DOS prompt
  165.  
  166.    4)  CHKDSK  will display its results along with the "bytes free" figure. 
  167.        In order to perform Jmodem transfers,  th